Release 10.1A: OpenEdge Application Server:
Administration

Setting environment variables

Environment variables required by WebSpeed are set in the ubroker.properties file during installation. You might also need to set the PROPATH and other standard environment variables (for example, DLC) on the WebSpeed Transaction Server machine.

Note: In distributed configurations, you must edit the appropriate environment variables on each machine where you have WebSpeed components installed.

You can change most of these settings using the Progress Explorer (remotely, from a Windows machine) or by editing the WebSpeed property file, ubroker.properties.

PROPATH and other standard OpenEdge environment variables

When you install the WebSpeed Transaction Server, the installation process sets PROPATH for you in the ubroker.properties file. PROPATH initially includes a number of subdirectories in your installation directory. In addition, the PROPATH includes a dot ( . ) directory reference. When the agent sees the dot, the process substitutes the name of its current working directory. For example, the agents resolve the dot to their broker’s default directory, which is the working directory.

You can modify this and other environment variable settings in the OpenEdge shell scripts installed on UNIX. You can override installed PROPATH settings using the PROPATH property in the properties file (ubroker.properties).

Working directory settings

The properties file relies on a default environment variable setting, stored in the WRKDIR environment variable, for the working directory that you specify during installation. You can remove or modify the references in the properties file to establish your own working directory settings for both the WebSpeed Transaction Server and the NameServer.

Configuring WebSpeed and NameServer log files

For disk management reasons, you might want to specify a nondefault location for the log files used by WebSpeed. A WebSpeed installation uses a number of different log files, which are stored in the default working directory. For example:

[TransactionServername.]server.log — WebSpeed Transaction Server log file set using the srvrLogFile property in the [Ubroker] section of the properties file.
[TransactionServername.]broker.log — WebSpeed broker log file set using the brokerLogFile property in the [Ubroker] section of the properties file.
[NameServername.]ns.log — NameServer log file set using the srvrLogFile property in the [NameServer] section of the properties file.

After you decide where you want log files to reside, you can specify the location for each in the Progress Explorer or by directly editing the ubroker.properties file. For more information, see the "Configuring WebSpeed components" section.

Log files can grow quickly. If you have the Append option set in the Transaction Server’s configuration, these log files do not truncate automatically. In this case, you should periodically trim the file with a text editor. You might want to archive the file contents as you do it. For more information on maintaining log files, see the "Maintaining the WebSpeed Transaction Server and NameServer log files" section.